Step 5 — Verify & Save Credentials in Whoxa CRM
With your Meta App configured, you now enter all credentials into Whoxa CRM and activate the connection.
Open Manual Configuration
- Log in to Whoxa CRM.
- Open WA Chat from the sidebar.
- Click Integrate WhatsApp.
- In the modal, click or configure manually.
Fill in the Form
Enter the following values (all found in your Meta App or Business Manager):
| Field | Where to Find It |
|---|---|
| Phone Number ID | Meta App Dashboard → WhatsApp → API Setup → Phone Number ID |
| WhatsApp Business Account ID | Meta Business Manager → WhatsApp Accounts → Account ID |
| Registered Phone Number | The phone number in international format, e.g., +919876543210 |
| Display Name (optional) | The name shown to customers (set during phone registration) |
| Access Token | Generated in Step 3 (permanent system user token) |
| Webhook Verify Token | The value your backend admin set for WHATSAPP_WEBHOOK_VERIFY_TOKEN — must match Step 4 exactly |
All fields except Display Name are required.
Save and Verify
- Click Save Configuration.
- Whoxa CRM saves the account and marks it active.
- The modal switches to a green WhatsApp Connected status card showing your business name, phone number, and IDs.
Send a Test Message
To confirm everything works end-to-end:
- Go to the Chat section of Whoxa CRM.
- Start a new conversation with a test phone number.
- Send a message and confirm it arrives on the recipient's WhatsApp.
- Reply from WhatsApp and confirm it appears in the CRM inbox.
Connection is active. Your agents can now send and receive WhatsApp messages directly from the Whoxa CRM dashboard.
Troubleshooting
| Problem | Likely Cause | Fix |
|---|---|---|
| "Invalid Access Token" | Token expired or wrong scopes | Regenerate token with correct permissions (Step 3) |
| Webhook verification failed | Server not reachable or wrong verify token | Check API server is live and token matches |
| Messages not appearing in CRM | Webhook fields not subscribed | Subscribe messages field in Meta (Step 4) |
| "Phone number already registered" | Number still on WhatsApp consumer app | Delete WhatsApp account on that device first |